ETSITS 129 198-2 V5.5.0 



(2003-12) 



Technical Specification 



Universal Mobile Telecommunications System (UMTS); 

Open Service Access (OSA) 
Application Programming Interface (API); 

Part 2: Common data 
(3GPP TS 29.198-02 version 5.5.0 Release 5) 



3ji^ 




U 



3GPP TS 29.1 98-02 version 5.5.0 Release 5 1 ETSI TS 1 29 1 98-2 V5.5.0 (2003-1 2) 



Reference 



RTS/TSGN-05291 98-02V550 
Keywords 



UMTS 



ETSI 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel. : +33 4 92 94 42 00 Fax: +33 4 93 65 47 1 6 

Siret N ° 348 623 562 0001 7 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.orq 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.orq/tb/status/status.asp 

If you find errors in the present document, send your comment to: 
editor(a)etsi.orq 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2003. 
All rights reserved. 

DECT'^", PLUGTESTS™ and UMTS™ are Trade IVlarks of ETSI registered for the benefit of its IVIembers. 
TIPHON^" and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 
2QppTM |g g jracle Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. 



ETSI 



3GPP TS 29.1 98-02 version 5.5.0 Release 5 2 ETSI TS 1 29 1 98-2 V5.5.0 (2003-1 2) 



Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http://webapp.etsi.org/kev/quervform.asp . 



ETSI 



3GPP TS 29.1 98-02 version 5.5.0 Release 5 3 ETSI TS 1 29 1 98-2 V5.5.0 (2003-1 2) 



Contents 



Intellectual Property Rights 2 

Foreword 2 

Foreword 5 

Introduction 5 

1 Scope 7 

2 References 7 

3 Definitions and abbreviations 8 

3.1 Definitions 8 

3.2 Abbreviations 8 

4 Common Data definitions 8 

5 Common System Data definitions 8 

5.1 Standard Data types 8 

5.1.1 TpBoolean 8 

5.1.2 Tplnt32 8 

5.1.3 TpFloat 8 

5.1.4 TpLongString 8 

5.1.5 TpOctet 8 

5.1.6 TpOctetSet 9 

5.1.7 TpString 9 

5.1.8 TpAssignmentID 9 

5.1.9 TpSessionID 9 

5.1.10 TpSessionlDSet 9 

5.1.11 TpAny 9 

5.1.12 TpAttribute 9 

5.1.13 TpAttributeValue 9 

5.1.14 TpAttributeList 10 

5.1.15 TpAttributeSet 10 

5.1.16 Tplnt64 10 

5.1.17 TpVersion 10 

5.1.18 TpStringSet 10 

5.1.19 TpStringList 11 

5.1.20 TpAttributeTaglnfb 11 

5.1.21 TpSimpleAttributeValue 11 

5.1.22 TpSimpleAttributeTypelnfo 11 

5.1.23 TpStructuredAttributeType 12 

5.1.24 TpStructuredAttributeValue 12 

5.1.25 TpChar 12 

5.1.26 TpWChar 12 

5.1.27 TpWString 12 

5.1.28 Tplntl6 12 

5.1.29 TpUnsignedIntl6 13 

5.1.30 TpUnsignedInt32 13 

5.1.31 TpUnsignedlnt64 13 

5.1.32 TpDouble 13 

5.1.33 TpFixed 13 

5.1.34 TpXMLString 13 

5.1.35 TpUnorderedOctetSet 13 

5.2 Other Data sorts 13 

5.2.1 Sequence of Data Elements 13 

5.2.2 Tagged Choice of Data Elements 13 

5.2.3 Numbered Set of Data Elements 14 

5.2.4 Reference 14 



£75/ 



3GPP TS 29.1 98-02 version 5.5.0 Release 5 4 ETSI TS 1 29 1 98-2 V5.5.0 (2003-1 2) 

5.2.5 Numbered List of Data Elements 14 

5.3 Interface Related Data definitions 14 

5.3.1 Iplnterface 14 

5.3.2 IpInterfaceRef 14 

5.4 Exception Classes 15 

5.4.1 Underlying Technology Exceptions 15 

5.4.2 TpCommonExceptions 15 

5.4.3 Constants associated with TpCommonExceptions 15 

5.4.4 Exceptions available to all methods on all interfaces 16 

5.5 Date- and Time-related Data definitions 16 

5.5.1 TpDate 16 

5.5.2 TpTime 17 

5.5.3 TpDateAndTime 17 

5.5.4 TpDuration 18 

5.5.5 TpTimelnterval 18 

5.6 Address-related Data definitions 18 

5.6.1 TpAddress 18 

5.6.2 TpAddressSet 19 

5.6.3 TpAddressPresentation 19 

5.6.4 TpAddressScreening 20 

5.6.5 TpAddressPlan 20 

5.6.6 TpAddressError 21 

5.6.7 TpAddressRange 21 

5.6.8 TpURL 22 

5.6.9 TpURN 22 

5.7 Price-related Data definitions 22 

5.7.1 TpPrice 22 

5.7.2 TpAoCInfo 22 

5.7.3 TpAoCOrder 23 

5.7.4 TpCallAoCOrderCategory 23 

5.7.5 TpChargeAdvicelnfo 23 

5.7.6 TpCAIElements 23 

5.7.7 TpChargePerTime 24 

5.7.8 TpLanguage 24 

5.8 Data Types Common Across Call Control and Data Session Control 24 

5.8.1 TpDataSessionQosClass 24 

Annex A (normative): OMG IDL Description of the Common Data definitions 25 

Annex B (informative): W3C WSDL Description of the Common Data definitions 26 

Annex C (informative): Java API Description of the Common Data definitions 27 

Annex D (normative): Exception Hierarchy 28 

Annex E (informative): Change history 37 

History 38 



£75/ 



3GPP TS 29.198-02 version 5.5.0 Release 5 



ETSI TS 129 198-2 V5.5.0 (2003-12) 



Foreword 



This Technical Specification has been produced by the 3' Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 
where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part 2 of a multi-part TS covering the 3' Generation Partnership Project: Technical 
Specification Group Core Network; Open Service Access (OSA); Application Programming Interface (API), as 
identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: 



Parti: 
Part 2: 

Part 3: 
Part 4: 



Parts 
Part 6 
Part? 
Parts 
Part 9 
Part 10 
Part 11 
Part 12 
Part 13 
Part 14 



"Overview"; 

"Common Data Definitions"; 

"Framework"; 

"Call Control"; 

Sub-part 1: "Call Control Common Definitions"; 

Sub-part 2: "Generic Call Control SCF"; 

Sub-part 3: "Multi-Party Call Control SCF"; 

Sub-part 4: "Multi-Media Call Control SCF"; 

Sub-part 5: "Conference Call Control SCF"; 

"User Interaction SCF"; 

"Mobility SCF"; 

"Terminal Capabihties SCF"; 

"Data Session Control SCF"; 

"Generic Messaging SCF"; 

"Connectivity Manager SCF"; 

"Account Management SCF"; 

"Charging SCF". 

"Policy Management SCF"; 

"Presence and Availability Management SCF"; 



(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(not part of 3GPP Release 5) 



(not part of 3GPP Release 5) 
(not part of 3GPP Release 5) 



(new in 3GPP Release 5) 
(new in 3GPP Release 5) 



The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. 
A mapping to network protocols is however not applicable for all Parts, but the numbering of Parts is kept. 
Also in case a Part is not supported in a Release, the numbering of the parts is maintained. 
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Table: Overview of the OSA APIs & Protocol Mappings 29.198 & 29.998-faniily 



OSA API specifications 29.198-family 


OSA API Mapping - 29.998-family 


29.198-01 


Overview 


29.998-01 


Overview 


29.198-02 


Common Data Definitions 


29.998-02 


Not Applicable 


29.198-03 


Framework 


29.998-03 


Not Applicable 


Call 
Control 
(CC) 
SCF 


29.198- 
04-1 

Common 
CC data 
definitions 


29.198- 
04-2 
Generic 
CCSCF 


29.198- 
04-3 
Multi- 
Party CC 
SCF 


29.198- 
04-4 
Multi- 
media CC 
SCF 


29.998-04-1 


Generic Call Control - CAP mapping 


29.998-04-2 


Generic Call Control — INAP mapping 


29.998-04-3 


Generic Call Control — Megaco mapping 


29.998-04-4 


Multiparty Call Control - SIP mapping 


29.198-05 


User Interaction SCF 


29.998-05-1 


User Interaction - CAP mapping 


29.998-05-2 


User Interaction — INAP mapping 


29.998-05-3 


User Interaction - Megaco mapping 


29.998-05-4 


User Interaction - SMS mapping 


29.198-06 


Mobility SCF 


29.998-06 


User Status and User Location - MAP mapping 


29.198-07 


Terminal Capabilities SCF 


29.998-07 


Not Applicable 


29.198-08 


Data Session Control SCF 


29.998-08 


Data Session Control - CAP mapping 


29.198-09 


Generic Messaging SCF 


29.998-09 


Not Applicable 


29.198-10 


Connectivity Manager SCF 


29.998-10 


Not Applicable 


29.198-11 


Account Management SCF 


29.998-11 


Not Applicable 


29.198-12 


Charging SCF 


29.998-12 


Not Applicable 


29.198-13 


Policy Management SCF 


29.998-13 


Not Applicable 


29.198-14 


Presence & Availability Management SCF 


29.998-14 


Not Applicable 
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Scope 



The present document is Part 2 of the Stage 3 specification for an Apphcation Programming Interface (API) for Open 
Service Access (OS A). 

The OSA specifications define an architecture that enables application developers to make use of network functionality 
through an open standardised interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA 
are contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Common Data definitions of the OSA. The Common Data definitions contain data- 
types that are common across the rest of the OSA API. All aspects of the Common Data are defined here, these being: 

Data definitions; 

IDL Description of the data types; 

WSDL Description of the data types; 

Reference to the Java API description of the data types. 

This specification has been defined jointly between 3GPP TSG CN WG5, ETSI TISPAN and The Parlay Group, in co- 
operation with a number of JAIN'"*^ Community member companies. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 29.198-1: "Open Service Access; Application Programming Interface; Part 1: 
Overview" . 

[2] 3GPP TS 22.127: "Stage 1 Service Requirement for the Open Service Access (OSA)". 

[3] 3GPP TS 23.127: "Virtual Home Environment". 

[4] ISO 8601: "Data elements and interchange formats - Information interchange - Representation of 

dates and times". 

[5] 3GPP TS 22.024: "Description of Charge Advice Information (CAI)". 

[6] IETF RFC 1738: "Uniform Resource Locators (URL)". 

[7] IETF RFC 0822: "Standard for the format of ARPA Internet text messages". 

[8] ISO 4217 (1995): "Codes for the representation of currencies and funds ". 

[9] ITU-T Recommendation E. 164: "The international public telecommunication numbering plan". 

[10] ITU-T Recommendation X.400: "Message handling system and service overview". 

[II] ISO 639: "Code for the representation of names of languages". 
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3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 29.198-1 [1] apply. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TS 29.198-1 [1] apply. 

4 Common Data definitions 

The following clauses describe each aspect of the Common Data definitions. 

The order is as follows: 

The Data definitions clause shows a detailed expansion of each of the data types associated with the methods 
within the classes. 

IDL description of the data types (normative Annex); 

WSDL description of the data types (informative Annex); 

Reference to the Java API description of the data types (informative Annex). 

5 Common System Data definitions 

These data definitions are assumed to be provided by the client operating system. 

5.1 Standard Data types 

The APIs assume that the following Data types can be supported. 

5.1.1 TpBoolean 

Defines a Boolean data type. 

5.1.2 Tplnt32 

Defines a signed 32-bit integer. 

5.1.3 TpFloat 

Defines a single precision real number. 

5.1.4 TpLongString 

Defines a Byte string, comprising length and data. The length shall be at least a 32-bit integer. 

5.1.5 TpOctet 

Defines an 8-bit quantity that is not translated during transmission. 



£75/ 



3GPP TS 29.198-02 version 5.5.0 Release 5 



ETSI TS 129 198-2 V5.5.0 (2003-12) 



5.1.6 TpOctetSet 

Defines a Numbered List of Data elements of TpOctet. Note that this is an ordered list. 

5.1.7 TpString 

Defines a Byte string, comprising length and data. The length shall be at least a 16-bit integer. 

5.1.8 TpAssignmentID 

Defines an assignment ID with a value that is unique to an instance of an implementation of a given interface (i.e an 
object), irrespective of the method invoked on it. This ID may be used, for example, to identify single or multiple event 
notifications enabled by an object; or by a requesting object to modify or stop functionality ( e.g event notifications, 
call load control) associated with a previously supplied assignment ID. 

The assignment ID is identical to a Tplnt32 type. 



5.1.9 TpSessionID 

Defines a session ID with a value that is at least unique within the context of a specific instance of an SCF. An instance 
of an SCF is a single service manager instance plus the associated subordinate instances. For example, a single 
MultiPartyCallControlManager instance plus all associated MultiPartyCall and MultiPartyCallLeg instances. The 
session ID is used to identify different sessions (e.g. different call or call leg sessions) of an interface capable of 
handling multiple sessions. 

Example 1, myCallObject may implement the IpCall interface. If so, myCallObject may handle multiple call sessions, 
and each call session will be identified by a call session ID value (e.g. 1, 2, 3) that is unique within the context of the 
SCF instance. 

Example 2, myCallAndCallLegObject may implement the IpCall and IpCallLeg interfaces. If so, 
myCallAndCallLegObject may handle multiple call sessions and multiple call leg sessions. Each call session will be 
identified by a call session ID value (e.g. 1, 2, 3) that is unique within the context of the SCF instance. Similarly, each 
call leg session will be identified by a call leg session ID value (e.g. 1, 2, 3, 4, 5, 6) that is also unique within the context 
of the SCF instance. Because call session IDs and call leg session IDs are different data types, overlapping values are 
permitted and their uniqueness still remains. 

The session ID is identical to a Tplnt32 type. 

5.1.10 TpSessionlDSet 

Defines a Numbered Set of Data Elements of TpSessionID . 

5.1.11 TpAny 

Defines a type that can hold any type. This is not restricted to only the primitive types. 

5.1.12 TpAttribute 

This is a Sequence of Data Elements containing the attribute name and value. 



Sequence Element Name 


Sequence Element 
Type 


Notes 


AttributeName 


TpString 


The name of the attribute. 


AttributeValue 


TpAttributeValue 


The typed value(s) for the attribute. 



5.1.13 TpAttributeValue 

This is a tagged choice of data elements to hold attribute values of different complexity. 
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Tag Element Type 






TpAttributeTaglnfo 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_SIMPLE_TYPE 


TpSimpleAttributeValue 


SimpleValue 


P_STRUCTURED_TYPE 


TpStructuredAttributeValue 


StructuredValue 


P_XML_TYPE 


TpXMLString 


XMLValue 



5.1.14 TpAttributeList 

This is a Numbered List of Data Elements of type Tp Attribute. 

5.1.15 TpAttributeSet 

This is a Numbered Set of Data Elements of type TpAttribute. 

5.1.16 Tplnt64 

Defines a signed 64-bit integer. 

5.1.17 TpVersion 

This data type is identical to TpString. It is used to uniquely identify the implemented version of the framework or 
an SCF. The syntax for this datatype is defined as: 

P_<publishing body>_<version number> 

Where: 

<publishing body> is one of the strings listed in the table below. 



Character String Value 


Description 


PARLAY 


Specification released by Tlie Parlay Group. 


ETSI 


Specification released by ETSI. 


3GPP 


Specification released by 3GPP. 



<version nuitiber> consists of numbers separated by underscores (e.g. 3_1). It is recommended that not more 
than the two most significant numbers (major and minor version) of the version are used. 

Examples of version strings are: 



Character String Value 


Description 


P_PARLAY_3_1 


Parlay v3.1 


P_ETSI_2_0 


ETSI v2.0 


P_3GPP_4_3 


3GPP Release 4.3 



Note that different version strings can be aliases of each other all pointing to the same SCF/Framework version. 

5.1.18 TpStringSet 

Defines a Numbered Set of Data Elements of type TpString. 
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5.1.19 TpStringList 



Defines a Numbered List of Data Elements of type TpString. 



5.1.20 TpAttributeTaglnfo 



TpAttributeTaglnfo is an enumerated type used as a discriminator for the TpAttribute Value structure, and can contain 
the following values: 



Name 


Value 


Description 


P_SIMPLE_TYPE 





simple type 


P_STRUCTURED_TYPE 


1 


Structured type 


P_XML_TYPE 


2 


XML type 



5.1.21 TpSimpleAttributeValue 



This is a tagged choice of data elements to hold attribute values of different complexity. 





Tag Element Type 






TpSimpleAttributeTypelnfo 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_BOOLEAN 


TpBoolean 


BooleanValue 


P_OCTET 


TpOctet 


OctetValue 


P_CHAR 


TpChar 


CharValue 


P_WCHAR 


TpWChar 


WCharValue 


P_STRING 


TpString 


StringValue 


P_WSTRING 


TpWString 


WStringValue 


P_INT16 


Tplntie 


Intievalue 


P_UNSIGNED_INT16 


TpUnsignedIntl6 


Unsigne dint 16 Value 


P_INT32 


Tplnt32 


Int32Value 


P_UNSIGNED_INT32 


TpUnsignedInt32 


Unsigne dint 3 2 Value 


P_INT64 


Tplnt64 


Int64Value 


P_UNSIGNED_INT64 


TpUnsignedInt64 


UnsignedInt64Value 


P_FLOAT 


TpFloat 


FloatValue 


P_DOUBLE 


TpDouble 


DoubleValue 


P_FIXED 


TpFixed 


FixedValue 



5.1.22 TpSimpleAttributeTypelnfo 

TpSimpleAttributeTypelnfo is an enumerated type used as a discriminator for the TpSimpleAttributeValue structure, 
and can contain the following values: 
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Name 


Value 


Description 


P_BOOLEAN 





Attribute type is type TpBoolean. 


P_OCTET 


1 


Attribute type is type TpOctet. 


P_CHAR 


2 


Attribute type is type TpChar. 


P_WCHAR 


3 


Attribute type is type TpWChar. 


P_STRING 


4 


Attribute type is type TpString. 


P_WSTRING 


5 


Attribute type is type TpWString. 


P_INT16 


6 


Attribute type is type Tplntl6. 


P_UNSIGNED_INT16 


7 


Attribute type is type TpUnsignedIntl6 . 


P_INT32 


8 


Attribute type is type Tplnt32. 


P_UNSIGNED_INT32 


9 


Attribute type is type TpUnsignedInt32 . 


P_INT64 


10 


Attribute type is type Tplnt64. 


P_UNSIGNED_INT64 


11 


Attribute type is type TpUnsignedInt64 . 


P_FLOAT 


12 


Attribute type is type TpFloat. 


P_DOUBLE 


13 


Attribute type is type TpDouble. 


P_FIXED 


14 


Attribute type is type TpFixed. 



5.1.23 TpStmcturedAttributeType 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies the type of a 
structured data type. Network operator specific capabilities may also be used, but should be preceded by the string 
"SP_". The pattern of values is defined, where module names and class names map to a fully specified class name. 



Character String Value 


Description 


P_modulel /module 2 /module 3 /className 


An object of the specified, fully qualified class. 



5.1 .24 TpStructuredAttribute Value 



This is a Sequence of Data Elements containing the structured attribute type tag and the value to be 
interpreted using that type. 



Sequence Element Name 


Sequence Element Type 


Notes 


Type 


TpStructuredAttributeType 


The type for the value. 


Value 


TpAny 


The structured values for the 
attribute . 



5.1.25 TpChar 

This type is an 8-bit quantity that may undergo conversion when transmitted by the communication system. 

5.1.26 TpWChar 

This type is a quantity that may undergo conversion when transmitted by the communication system. The size of this 
type is implementation-dependent. 

5.1.27 TpWString 

Defines a TpWChar string, comprising length and data. The length shall be at least a 16-bit integer. 

5.1.28 Tplntie 

Defines a signed 16-bit integer. 
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5.1.29 TpUnsignedlnt16 

Defines an unsigned 16-bit integer. 

5.1.30 TpUnsignedlnt32 

Defines an unsigned 32-bit integer. 

5.1.31 TpUnsignedlnt64 

Defines an unsigned 64-bit integer. 

5.1.32 TpDouble 

Defines a double precision real number. 

5.1.33 TpFixed 

This data type defines a fixed-point decimal number of up to 31 significant digits. The scale factor is a non-negative 
integer less than or equal to the total number of digits. 

5.1.34 TpXMLString 

This data type is TpString containing well-formed XML and may contain a reference to/include a DTD or Schema. 

5.1.35 TpUnorderedOctetSet 

Defines a Numbered Set of Data elements of TpOctet. Note that this is an un-ordered set. 

Note that this type should not be removed from this specification, even if unused by any part of the OS A specifications. 
It is included to ensure that TpOctetSet is correctly used as a Numbered List of Data Elements, and not a Numbered Set. 

5.2 Other Data sorts 

The APIs assumes that the following data syntaxes can be supported: 

5.2.1 Sequence of Data Elements 

This describes a sequence of data types. This may be defined as a structure (for example, in C-H-) or simply a sequence 
of data elements within a structure. 

EXAMPLE: The TpAddress data type may be defined in C-n- as: 

typedef struct { 

TpAddressPlan Plan; 

TpString AddrString; 

TpString Name; 

TpAddressPresentation Presentation; 

. . . . TpAddressScreening Screening; 

. . . .TpString SubAddressString; 

} TpAddress; 



5.2.2 Tagged Choice of Data Elements 



This describes a data type which actually evaluates to one of a choice of a number of data elements. This data element 
contains two parts: a tag data type (the tag part) which is used to identify the chosen data type, and the chosen data type 
itself (the union part). This form of data type is also referred to as a tagged union. 

This data type can be implemented (for example, in C++) as a structure containing an integer for the tag part, and a 
union for the union part. 
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This data type is implementation specific. Please refer to the appropriate IDL documents (and the resulting language 
mappings) to see how this data type is implemented. 

EXAMPLE: The TpCallError data type may be defined in C++ as: 

typedef struct { 

TpCallErrorType Tag; 
union { 

TpCallErrorInf oUndef ined Undefined; 

TpCallErrorInf oRoutingAborted Rout ingAbor ted; 

TpCallErrorInf oCallAbandoned Call Abandoned; 

TpCallErrorInf oInvalidAddress InvalidAddress; 

TpCallErrorlnfoInvalidState InvalidState; 

TpCallErrorInf oInvalidCr iter i a InvalidCriteria; 
} callErrorInf o; 
} TpCallError; 

5.2.3 Numbered Set of Data Elements 

This describes a data type which comprises an integer which indicates the total number of data elements in the set (the 
number pan), and an unordered set of data elements (the data part). Set data types do not contain duplicate data 
elements. 

Note that TpOctetSet is a Numbered List of Data Elements, not a Numbered Set. 

EXAMPLE: The TpAddressSet data type may be defined in C++ as: 

typedef struct { 

Tplnt32 Number; 

TpAddress Set [Number] ; 
} TpAddressSet; 

5.2.4 Reference 

This describes a reference (or pointer) to a data type. When one interface inherits directly from another interface, a 
reference to the inheriting interface can be used when the base interface reference is required. For example, the 
references to Multi-Media Call Control interfaces can be used in Multi-Party Call Control methods that have been 
inherited by Multi-Media Call Control from Multi-Party Call Control interfaces. 

5.2.5 Numbered List of Data Elements 

This describes a data type which comprises an integer which indicates the total number of data elements in the set (the 
number part), and an ordered set of data elements (the data part). List data types can contain duplicate data elements. 

EXAMPLE: The TpStringList data type may be defined in C++ as: 

typedef struct { 

Tplnt32 Number; 

TpString List [Number] ; 
} TpStringList; 

5.3 Interface Related Data definitions 

5.3.1 Iplnterface 

Defines the address of a generic interface instance. 

5.3.2 IplnterfaceRef 

Defines a Reference to type Iplnterface. 
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5.4 Exception Classes 



5.4.1 Underlying Technology Exceptions 

All methods contain a signature showing, amongst other things, the explicit exceptions that they may throw. In addition 
to these exceptions, all methods can throw a number of implicit exceptions. These exceptions do not need to be included 
within the method signatures and are given below. 

These exceptions would be thrown by the underlying technology (e.g. CORBA, Java) as a result of problems 
encountered, for example, with the way the API method is invoked. They are a minimum set of exceptions that must be 
throwable by the underlying technology. Depending upon the underlying technology, additional method exceptions may 
also be thrown. 



Description 



Invalid Parameter: A method has been passed an invahd parameter argument 



Invalid Parameter Value: A method parameter has been passed a value that is out of range 
Parameter Missing: A method has not been passed a mandatory parameter argument 



5.4.2 TpCommonExceptions 

Defines the structure of the exception class which is applicable to all methods. 



Structure Element Name 


Structure Element Type 


Structure Element Description 


ExceptionType 


Tplnt32 


Carries a constant from the list in the table below 


Extrainf ormation 


TpString 


Carries extra information to help identify the source of the exception, e.g. 
a parameter name 



5.4.3 Constants associated with TpCommonExceptions 



Name 


Value 


Description 


P_RE SOURCE S_UNAVAI LABLE 


OOODh 


The required resources in the network are not available 


P_TASK_REFUSED 


OOOEh 


The requested method has been refused 


P_TASK_CANCELLED 


OOOFh 


The requested method has been cancelled 


P_NO_CALLBACK_ADDRESS_SET 


001 Ih 


The requested method is refused because no callback address has been set (this may be the result 
of a timing issue between setting the callback address and invoking the method) 


P_METHOD_NOT_SUPPORTED 


0016h 


The method is not allowed or supported within the context of the current service agreement. 


P_INVALID_STATE 


02E8h 


Unexpected sequence of methods, i.e., the sequence does not match the specified state diagrams. 
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5.4.4 Exceptions available to all methods on all interfaces 

The following are the list of exception classes which are available to all interfaces of the API. 



Name 


Description 


P_APPLICATION_NOT_ACTIVATED 


An application is unauthorised to access information and request services with regards to users that 
have deactivated that particular application. 

In case the request was for information related to multiple user identities the reference to user 
identities that are causing this exception will be returned in the extra information of the exception. 


P_INFORMATION_NOT_AVAILABLE 


The requested information is not available. A reason might be that the information is unavailable in 

the core network or that the application is unauthorised to access the information. An application is 

unauthorised to access information and request services with regards to users that have set their 

privacy flag regarding that particular service. In case the request was for information related to 

multiple user identities, the reference to user identities that are causing this exception will be returned 

in the extra information of the exception. 


P_I NVAL I D_AD D RE S S 


Invalid address specified 


P_INVALID_AMOUNT 


Invalid amount specified. 


P_INVALID_ASSIGNMENT_ID 


The assignment ID is invalid 


P_INVALID_CRITERIA 


Invahd criteria specified 


P_INVALID_CURRENCY 


Invalid currency specified. 


P_INVALID_EVENT_TYPE 


Invalid event type 


P_INVALID_INTERFACE_NAME 


Invalid interface name 


P_INVALID_INTERFACE_TYPE 


The interface reference supplied by the client is the wrong type. 


P_I NVAL I D_NE TWORK_S TATE 


Although the sequence of method calls is allowed by the gateway, the underlying protocol can not 

support it. 

E.g., in some protocols some methods are only allowed by the protocol, when the call processing is 
suspended, e.g., after reporting an event that was monitored in interrupt mode. 


P_INVALID_SESSION_ID 


Invahd session ID. 


P_INVALID_TIME_AND_DATE_FORMAT 


Invahd date and time format provided 


P_UNAUTHORI SED_PARAMETER_VALUE 


A method parameter value violates the Service Level Agreement 


P_UNKNOWN_SUBSCRIBER 


The subscriber is not known in the network or the apphcation is An apphcation is unauthoiised to 
access information and request services with regards to users that are not subscribed to the 

application. 

In case the request was for information related to multiple user identities, the reference to user 
identities that are causing this exception will be returned in the extra information of the exception. 


P_UNSUPPORTED_ADDRESS_PLAN 


An address contains an address plan which is not supported 


P_INVALID_VERSION 


An invalid version is specified. 



5.5 



Date- and Time-related Data definitions 



5.5.1 TpDate 

This data type is identical to a TpString . It specifies the data in accordance with International Standard ISO 8601 [4]. 
This is defined as the string of characters in the following format: 

YYYY-MM-DD 

where the date is specified as: 

YYYY four digits year 

MM two digits month 

DD two digits day 

The date elements are separated by a hyphen character (-). 

EXAMPLE: The 4 December 1998, is encoded as the string: 
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1998-12-04 



5.5.2 TpTime 



This data type is identical to a TpString . It specifies the time in accordance with International Standard ISO 8601 [4]. 
This is defined as the string of characters in the following format; 

HH:MM:SS.iiiiiim 

or 

HH:MM:SS.iiiiiimZ 

where the time is specified as: 

HH two digits hours (24h notation) 

MM two digits minutes 

S S two digits seconds 

mmm three digits fractions of a second (i.e. milliseconds) 

The time elements are separated by a colon character ( : ). The date and time are separated by a space. Optionally, a 
capital letter Z may be appended to the time field to indicate Universal Time Co-ordinated (UTC). Otherwise, local time 
is assumed. 

EXAMPLE: 10:30 and 15 seconds is encoded as the string: 

10:30:15.000 

for local time, or in UTC it would be: 10:30:15. OOOZ 



5.5.3 TpDateAndTime 



This data type is identical to a TpString . It specifies the data and time in accordance with International Standard 
ISO 8601 [4]. This is defined as the string of characters in the following format: 

YYYY-MM-DD HH:MM: SS .mmm 

or 

YYYY-MM-DD HH:MM: SS .mmmZ 

where the date is specified as: 

YYYY four digits year 

MM two digits month 

DD two digits day 

The date elements are separated by a hyphen character (-). 

The time is specified as: 

HH two digits hours (24h notation) 

MM two digits minutes 

S S two digits seconds 

mmm three digits fractions of a second (i.e. milliseconds) 

The time elements are separated by a colon character ( : ).The date and time are separated by a space. Optionally, a 
capital letter Z may be appended to the time field to indicate Universal Time Co-ordinated (UTC). Otherwise, local time 
is assumed. 
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EXAMPLE: The 4 December 1998, at 10:30 and 15 seconds is encoded as the string: 

1998-12-04 10:30:15.000 
for local time, or in UTC it would be: 

1998-12-04 10:30:15. OOOZ 

5.5.4 TpDuration 

This data type is a Tplnt32 representing a time interval in milliseconds. A value of "-1" defines infinite duration and a 
value of "-2" represents a default duration. 

5.5.5 TpTimelnterval 

Defines the Sequence of Data Elements that specify a time interval. 



Sequence Element Name 


Sequence Element Type 


StartTime 


TpDateAndTime 


StopTime 


TpDateAndTime 



5.6 Address-related Data definitions 



5.6.1 TpAddress 

Defines the Sequence of Data Elements that specify an address. 



Sequence Element Name 


Sequence Element Type 


Plan 


TpAddressPlan 


AddrString 


TpString 


Name 


TpString 


Presentation 


TpAddressPresentation 


Screening 


TpAddress Screening 


SubAddressString 


TpString 
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The AddrString defines the actual address information and the structure of the string depends on the Plan. 
The following table gives an overview of the format of the AddrString for the different address plans. 



Address Plan 


AddrString Format Description 


Example 


P_ADDRESS_PLAN_NOT_PRESENT 


Not applicable 




P_ADDRESS_PLAN_UNDEFINED 


Not applicable 




P_ADDRESS_PLAN_IP 


For Ipv4 the dotted quad notation is used. Also for IPv6 the 

dotted notation is used. The address can optionally be 

followed by a port number separated by a colon. 


"127.0.0.1:42" 


P_ADDRESS_PLAN_MULTICAST 


An Ipv4 class D address or Ipv6 equivalent in dotted notation. 


"224.0.0.0" 


P_ADDRESS_PLAN_UNICAST 


A non-multicast or broadcast IP address in dotted notation. 


"127.0.0.1" 


P_ADDRESS_PLAN_E164 


An international number without the international access code, 

including the country code and excluding the leading zero of 

the area code. 


"31161249111" 


P_ADDRE S S_PLAN_AESA 


The ATM End System Address in binary format (40 bytes) 


01 234567890ABCDEF01 234 
567890ABCDEF01 234567 


P_ADDRE S S_PLAN_URL 


A uniform resource locator as defined in IETF RFC 1738 [6] 


"http://www.parlay.org" 


P_ADDRE S S_PLAN_NSAP 


The binary representation of the Network Service Access 
Point 


490001 AA00040001 0420 


P_ADDRESS_PLAN_SMTP 


An e-mail address as specified in IETF RFC822 [7] 


"webmaster@parlay.org" 


P_ADDRESS_PLAN_X4 00 


The X400 address structured as a set of attribute value pairs 
separated by semicolons. 


"C=nl;ADMD=;PRMD=uninet 

;0=parlay;S=Doe;l=S;G=Joh 

n' 


P_ADDRESS_PLAN_SIP (Note 1) 


Any vaUd address string allowed in RFC 3261 "SIP: Session 
Initiation Protocol" 


"sip:user@parlay.org" 

"tel:-i-358-555- 
I234567;postd=pp22" 

"<sip:enquiries@1.2.3.4:5060> 
Enquiries" 


P_ADDRESS_PLAN_ANY (Note 2) 


Not applicable 




P_ADDRESS_PLAN_NATIONAL 


Reserved for National Specific use 


Refer to relevant National 

Numbering Plan 

Specification 


NOTE 1 : It should be noted that two SIP addresses will be regarded as equivalent by a gateway if they correspond to 

the same user at the same network address. The textual form of the two addresses need not be the same. For 
example, sip:enquiries(?pariay .org will be deemed to match 

<sip : EnquiriesSl . 2.3.4: 5060>Enquiries (if parlay . org resolves tO 1 . 2 . 3 . 4). 
NOTE 2: This is only to be used with TpAddressRange 



5.6.2 TpAddressSet 

Defines a Numbered Set of Data Elements of TpAddress . 

5.6.3 TpAddressPresentation 

Defines whether an address can be presented to an end user. 



Name 


Value 


Description 


P_ADDRESS_PRESENTATION_UNDEFINED 





Undefined 


P_ADDRESS_PRESENTATION_ALLOWED 


1 


Presentation Allowed 


P_ADDRESS_PRESENTATION_RESTRICTED 


2 


Presentation Restricted 


P_ADDRESS_PRESENTATION_ADDRESS_NOT„AVAILABLE 


3 


Address not available for presentation 
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5.6.4 TpAddressScreening 

Defines whether an address can be presented to an end user. 



Name 


Value 


Description 


P_ADDRESS_SCREENING_UNDEFINED 





Undefined 


P_ADDRESS_SCREENING_USER_VERIFIED_PASSED 


1 


user provided address 
verified and passed 


P_ADDRESS_SCREENING_USER_NOT_VERIFIED 


2 


user provided address 
not verified 


P_ADDRESS_SCREENING_USER_VERIFIED_FAILED 


3 


user provided address 
verified and failed 


P_ADDRESS_SCREENING_NETWORK 


4 


Network provided address (see Note) 


NOTE: Even though the application may provide the address to the gateway, from the end-user point of view it is still 
regarded as a network provided address. 



5.6.5 TpAddressPlan 

Defines the address plan (or numbering plan) used. It is also used to indicate whether an address is actually defined in a 
TpAddress data element. 



Name 


Value 


Description 


P_ADDRESS_PLAN_NOT_P RESENT 





No Address Present 


P_ADDRESS_PLAN_UNDEFINED 


1 


Undefined 


P_ADDRESS_PLAN_IP 


2 


IP 


P_ADDRESS_PLAN_MULTICAST 


3 


Multicast 


P_ADDRESS_PLAN_UNICAST 


4 


Unicast 


P_AD D RE S S_P L AN_E 164 


5 


E.164 


P_ADDRE S S_PLAN_AE SA 


6 


AESA 


P_ADDRE S S_PLAN_URL 


7 


URL 


P_ADDRESS_PLAN_NSAP 


8 


NSAP 


P_ADDRESS_PLAN_SMTP 


9 


SMTP 


«deprecated» P_ADDRESS_PLAN_MSMAIL (see Note) 


10 


Microsoft Mail 


P_ADDRESS_PLAN_X4 00 


11 


X.400 


P_ADDRESS_PLAN_SIP 


12 


Any URL scheme which is allowed in RFC 
3261 "SIP: Session Initiation Protocol" 


P_ADDRESS_PLAN_ANY 


13 


Any address plan is deemed to match (This is 
only used for TpAddressRange) 


P_ADDRESS_PLAN_NATIONAL 


14 


Reserved for National Specific use 


NOTE: This value is not to be used. | 



For the case where the P_ADDRESS_PLAN_NOT_PRESENT and P_ADDRESS_PLAN_ANY are indicated, the rest of 
the information in the TpAddress is not valid. 
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5.6.6 TpAddressError 

Defines the reasons why an address is invahd. 



Name 


Value 


Description 


P_ADDRESS_INVALID_UNDEFINED 





Undefined enor 


P_ADDRESS_INVALID_MISSING 


1 


Mandatory address not present 


P_ADDRESS_INVALID_MISSING_ELEMENT 


2 


Mandatoiy address element not present 


P_ADDRESS_INVALID_OUT_OF_RANGE 


3 


Address is outside of the valid range 


P_ADDRESS_INVALID_INCOMPLETE 


4 


Address is incomplete 


P_ADDRESS_INVALID_CANNOT_DECODE 


5 


Address cannot be decoded 



5.6.7 TpAddressRange 

Defines the Sequence of Data Elements that specify a range of addresses. 



Sequence Element Name 


Sequence Element Type 


Plan 


TpAddressPlan 


AddrString 


TpString 


Name 


TpString 


SubAddressString 


TpString 



The AddrString defines the actual address information and the structure of the string depends on the Plan. 

An overview of the AddrString formats can be found at the description of the TpAddress data-type. 

The difference with TpAddress is that there are no Presentation and Screening elements, the AddrString can contain 
wildcards and Plan may contain P_ADDRESS_PLAN_ANY. 

If P_ADDRESS_PLAN_ANY is set then the TpAddressRange will be deemed by the gateway to match any TpAddress. 
If a specific Plan is set (including P_ADDRESS_PLAN_NOT_P RESENT) then the address plan of the range must be 
identical to the plan contained in an address for the two to match. 

Two wildcards are allowed: * which matches zero or more characters and ? which matches exactly one character. For 
E.164 addresses, * which matches zero or more characters and ? are allowed at the beginning or end. 

Some examples for E.164 addresses: 

"123" matches specified number; 

"123*"matches all numbers starting with 123 (including 123 itself); 

"123??*" matches all numbers starting with 123 and at least 5 digits long; 

"123???" matches all numbers starting with 123 and exactly 6 digits long; 

"*" matches any address 
The following address ranges are illegal: 
- "1?3" 

"1 H=T" 

"?123*" 



Legal occurrences of the '*' and '?' characters in AddrString should be escaped by a '\' character. To specify a 'V 
character 'W shall be used. 
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For e-mail style addresses, the wildcards are allowed at the beginning of the AddrString: 

"*@parlay.org" matches all email addresses in the parlay.org domain. 
For SIP addresses, a range of wildcard options may be supported: 

"sip:*@parlay.org" matches all SIP addresses at parlay.org:5060. 

"sip:*. domainl.com" Matches all SIP addresses in the domain domainl.com 

Matches all users starting with the string "user" 

Matches all users starting with the string "user" using port 5060 

Matches all SIP addresses 

Matches all SIP addresses 

Matches all users starting with the string "user" using port 5060 



sip:user*(a'* 
"sip:user*@*:5060" 
"sip:*" 



"sip:user*@*:5060" 



In addition for SIP addresses, the absence of an explicit port number at the end of a SIP address, shall be considered to 
indicate an implicit wildcard for any port number. 

"sip: userl ©parlay. org " may be considered equivalent to "sip:userl @parlay.org:*" 



5.6.8 TpURL 

This data type is identical to a TpString and contains a URL address. The usage of this type is distinct from TpAddress , 
which can also hold a URL. The latter contains a user address which can be specified in many ways: IP, e-mail, URL 
etc. On the other hand, the TpURL type does not hold the address of a user and always represents a URL. This type is 
used in user interaction and defines the URL of the test or stream to be sent to an end-user. It is therefore inappropriate 
to use a general address here. 



5.6.9 TpURN 



This data type is identical to a TpString and contains a URN value. This type is used in SCFs such as Presence Service 
and defines the URN of a "presentity" (i.e., a representation of an end-user). The syntax of what constitutes a valid 
URN is in IETF RCC 1737. e.g., ("urn: foo.com: bar"). 



5.7 



Price-related Data definitions 



5.7.1 TpPrice 

This data type is identical to a TpString . It specifies price information. This is defined as a string of characters (digits) in 
the following format: 

DDDDDD . DD 

5.7.2 TpAoClnfo 

Defines the Sequence of Data Elements that specify the Advice Of Charge information to be sent to the terminal. 



Sequence Element Name 


Sequence Element Type 


Description 


ChargeOrder 


TpAoCOrder 


Charge order 


Currency 


TpString 


CuiTency unit according to 180-4217:1995 [8] 
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5.7.3 TpAoCOrder 

Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 





Tag Element Type 






TpCallAoCOrderCategory 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CHARGE_ADVICE_INFO 


TpChargeAdvicelnfo 


ChargeAdvicelnfo 


P_CHARGE_PER_TIME 


TpChargePerTime 


ChargePerTime 


P_CHARGE_NETWORK 


TpString 


NetworkCharge 



5.7.4 TpCallAoCOrderCategory 



Name 


Value 


Description 


P_CHARGE_ADVICE_INFO 





Set of GSM Charge Advice Information elements according to 3GPP TS 22.024 [5] 


P_CHARGE_PER_TIME 


1 


Charge per time 


P_CHARGE_NETWORK 


2 


Operator specific charge plan specification, e.g. charging table name / charging table entry 



5.7.5 TpChargeAdvicelnfo 

Defines the Sequence of Data Elements that specify the two sets of Advice of Charge parameters. The first set defines 
the current tariff. The second set may be used in case of a tariff switch in the network. 



Sequence Element Name 


Sequence Element Type 


Description 


CurrentCAI 


TpCAIElements 


Current tariff 


NextCAI 


TpCAIElements 


Next tariff after tariff switch 



5.7.6 TpCAIElements 



Defines the Sequence of Data Elements that specify the Charging Advice Information elements according to 

3GPPTS 22.024 [5]. 



Sequence Element Name 


Sequence Element Type 


Description 


Unit sPer Interval 


Tplnt32 


Units per interval 


SecondsPerTime Interval 


Tplnt32 


Seconds per time interval 


ScalingFactor 


Tplnt32 


Scaling factor 


Unit Increment 


Tplnt32 


Unit increment 


Unit sPerDat a Interval 


Tplnt32 


Units per data interval 


Segment sPerDatalnterval 


Tplnt32 


Segments per data interval 


InitialSecsPerTime Interval 


Tplnt32 


Initial sees per time interval 
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5.7.7 TpChargePerTime 



Defines the Sequence of Data Elements that specify the time based charging information. 



Sequence Element Name 


Sequence Element Type 


Description 


InitialCharge 


Tplnt32 


Initial charge amount (in currency units * 0.0001) 


Cur rent Char gePerMinute 


Tplnt32 


Current tariff (in currency units * 0.0001) 


Next Char gePerMlnute 


Tplnt32 


Next tariff (in currency units * 0.0001) after tariff switch 
Only used in setAdviceOfCharge() 



5.7.8 TpLanguage 

This data type is identical to a TpString, and defines the language. In case an indication for the language is not needed 
an empty string shall be used. In other cases valid language strings are defined in ISO 639 [11]. 



5.8 Data Types Common Across Call Control and Data Session 
Control 



5.8.1 TpDataSessionQosClass 



Defines the Quality of Service (QoS) classes. This could be for a data session or multi media call session, for example. 



Name 


Value 


Description 


P_DATA_SESSION_QOS_CLASS_CONVERSATIONAL 





Specifies the Conversational QoS class, as 
specified in 3GTS 23.107. 


P_DATA_SESSION_QOS_CLASS_STREAMING 


1 


Specifies the Streaming QoS class, as specified 
in 3GTS 23.107. 


P_DATA_SESSION_QOS_CLASS_INTERACTIVE 


2 


Specifies the Interactive QoS class, as 
specified in 3GTS 23.107. 


P_DATA_SESSION_QOS_CLASS_BACKGROUND 


3 


Specifies the Background QoS class, as 
specified in 3GTS 23.107. 



Note: Because of commonality across multiple interface specifications, this data type is promoted from Data Session 
Control Data Types to Common Data Types. For backward compatibility reasons, the naming of the data 
type remains unmodified, and hence continues to refer to Data Session Control. 
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Annex A (normative): 

OMG IDL Description of the Common Data definitions 

The OMG IDL representation of the present document is contained in a text file (osa.idl contained in archive 
2919802IDL.ZIP) which accompanies the present document. 



£75/ 



3GPP TS 29.1 98-02 version 5.5.0 Release 5 26 ETSI TS 1 29 1 98-2 V5.5.0 (2003-1 2) 

Annex B (informative): 

W3C WSDL Description of the Common Data definitions 

The W3C WSDL representation of this specification is contained in a text file (osa.wsdl contained in archive 
2919802WSDL.ZIP) which accompanies the present document. 
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Annex C (informative): 

Java API Description of the Common Data definitions 

The Java API realisation of this specification is produced in accordance with the Java Realisation rules defined in Part 1 
of this specification series. These rules aim to deliver for Java, a developer API, provided as a realisation, supporting a 
Java API that represents the UML specifications. The rules support the production of both J2SE and J2EE versions of 
the API from the common UML specifications. 

The J2SE representation of this specification is provided as Java Code, contained in archive 2919802J2SE.ZIP that 
accompanies the present document. 

The J2EE representation of this specification is provided as Java Code, contained in archive 2919802J2EE.ZIP that 
accompanies the present document. 
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Annex D (normative): 
Exception Hierarchy 



This clause arranges the OS A exceptions as a set of hierarchies that, depending upon the technology realisation, may or 
may not be utilised to simplify software developers' code. 

If the exception hierarchy is used in a particular realisation, the following lists all the OSA abstract exceptions: 

• TpCommonExceptions 

• TpInvalidArgumentException 

• TpDataSessionException 

• TpAccountException 

• TpConnectivityException 

• TpFrameworkException 

• TpMobilityException 

• TpMessagingException 

• TpPamException 

• TpPolicyException 



If the exception hierarchy is being used in a particular realisation, a software developer will have the option to catch 
these abstract exceptions and/or the detailed exceptions which extend them. 

The following diagrams show all the OSA detailed exceptions, and how they relate to the abstract exceptions shown 
previously. 

It should be noted that for those OSA methods that raise TpCommonExceptions, the 
P_RESOURCES_UNAVAILABLE, P_TASK_CANCELLED, P_TASK_REFUSED, 

P_METHOD_NOT_SUPPORTED, P_INVALID_STATE and P_NO_CALLBACK_ADDRESS_SET detailed 
exceptions should be raised individually in the method signature. The software developer will thus have the option of 
catching them individually or catching the TpCommonExceptions abstract exception. 
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« Except! on» 
TpCommonExceptions 




«E)ception» / / 
P_RESOURCES_UNAyAILABLE 


«E)ception» 
P TASK CANCELLED 


«^«eption» 
P_TASK_REFUSED 


« Except! on» 
P_APPLICATION_NOT_ACTIVATED 














\ \ 




«E)ception» 
P_M ETHOD_NOT_SU PPORTED 


«Exception» 
PJNVALID_STATE 


V^" 

«t)ception» 
P_N 0_C ALLBAC K_AD D R ESS_SET 





















« Except! on» 
■i FORIVIATION_NOT_AVAILABLE 



«Excepticn» 
P_UNAUTHORISED_PARAIVIETER_VALUE 



«Exception» 
P INVALID NETWORK STATE 
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<<E)€qDtion>> 
TplnvalidArgumentE)ception 




«Ex;eption» 
P_INVAUD_VOLUM^ 



<<E)ception» 
P_GMS_INVALID_MAILBOX 



«ife)<ceptiph» 
P_INVAUD_CRJTERIA; 



\ <'«E)ceptit)n» X^ <<E)ception» 

P_iNVALID_CtJRRENCY P_INVALID_ENT_OP_ID 



«Exception>> / j <<E>ception>> 
P_GMS_INVALID_FOLDER_ID , PjNVALID_AMOUNT 



I «Exdeption>> '; 
P IMVALID IeVENT TYPE 



\ «Exception»^ 
'_INVALID_PROPERTY 



« Except! on>> 
P_INVALID_USER 



«E)€eption>> 
P_INVALID_SESSION_ID 



<<E)ception» ' «Exception>> , 

PJI)1VALID_M TERRACE NAME ,' P_INVALID_SAG_lb 



<<E)ception>> 
P_lNVALio_TlME_AIMD_DATE. FORMAT 



<<E)ception» / / / «Exception» 

P MVALD REQUEST NUMBER P INVALID ACCESS TVPE 



I <<Exception» \ 

pjN valid_ser VI cE_foK m 



«E)(Eeption» 
P INVALID SERVICE PROFILE ID 



<<Exception>> / <<Exception>> 

P INVALID ENCRYPTIOKl C/APABILITY P INVALID; SERVICE CONTRACT ID 



<<Exception>> 
P INVALID ACCOUNT 



<< Except! on>> 
P INVALID INTERFACE TYPE 



<<Exception>> ,' «Exception>> 

P_GMS_INVALID_AUTHENTICATION_IN FORMATION P_GMS_INVALID_MESSAGE_ID 



«Exception>> <<Exception>> 

P_INVALID_ADDRESS P_INVALID_SERVICE_ID 



«E)C^lion>> 
P_INVA.ID_COLLECTDN_CRITERIA 



«Exception>> 
P_INVALID_VERSION 



A 



«Exception>> 
P_UNSUPPORTED_ADDRESS_PLjAN 
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«Exception» 
P ILLEGAL SAG ID 



«Exception» 
P ILLEGAL SLA ID 



«Exception» 
P_ILLEGAL_VALUE 


«Exception» 
P_ILLEGAL_RANGE 


«Exception» 
P_ILLEGAL_TAG 
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«Exception>: 
P_UNKNOWN_ENTCRPRt6E^KlET\/yO0K 



j! i i i' «Exception» 
P_P;Kivi; (J N KN OW N_ATTR I ^U tES 



«Mception» 
P CiNKNOWNxTEMPLATE Pi'PE 



«Exception» I / ^ 

P_UNKNOWN_SITEj!ociTION/ / 



«Except'iohf» 
P UNKNOWN; IPSUBNET 



^1 — n 

«Exception>;V / / 

P UNKNOWN PIPBEJOSINf^o/ 



«Exception» / 
P_PAM_UNKNOWN_ATThlBliTE 



«Exception» 
P_U N KN O W N_|'NTE R F AC E 



«Except'ion» 
P_UNKNOWN^TEMPLATES 



«Except(on» 
P_UNI^N6v\i,N_SAP 



\ \ «Ekoeption» 
P_PAM_UNKNOWN_AGENT 



«^xception» 
P UNKI^OWN, STATUS 



\ «B<ception» 
P PAM UNKNOWN GROUP 



;te<Exception» 
P_PAM_tlNKNOWN_IDENTITY \ 



\ «Exception» 
P\UNKN0WN_VPRP 



«Exception» / / 
P UNKNOWN QOS INFO 



«Exception>:^ 
P PAM UNKNOWN MEMBER 



«Exc,eption» 
P UNKNOWN iVAUDITY INFO 



\«Exception» 

p Unknown vprn 



«Exception» 
P_PAM_UNKNOWN_GAPABILITY 



«Exception» 

p_unknown_vprp_i D 


«Exception» 
P_PAM_UNKNOWN_ALIAS 











«Exception>> 
P ID NOT FOUND 



«Exception» 
P PAM UNKNOWN ASSIGNMENT 
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«Exception» 
TpAccountException 



«Exception>> 
TpConnectivityException 



«Exception» 
UNAUTHORIZED APPLICATION 



«Exception» 
P CANT DELETE VPRP 



«Exceplion» 
TpFrameworkException 



«Exception» 
P SERVICE ACCESS DENlEC 




«Exception^> \ 
^FOPERTM TYPE MISMATCH 



«Exception» 
P SERVJCE fyPE UNAVAILABLE 



«Exception» 
P_NO_ACCEPTABLE_ENCRYPTION_^APABILITY 



«Exception» 
P ACCESS DENIED 



«Exception» 
P_MISSINIG_MANDATORY_PROPERTY 



«Exception» 
P_SERVICE_NOT_ENABLEb 



«Exception» 

rLduplicate_property_name 



«Exception» 
P NO ACCEPTABLE AUTHENTICATION MECHANISM 



«Exception» 
P_NO_ACCEPTABLE_SIGNING^ALGORITHM 



«Exception» 
P_INVALID_ADDITION_TO_SAG 



«Exception» 
P_INVALID_SAG_TO_SERVICE_PROFILE_ASSIGNMENT 
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«E)ception» 
TpMobilityException 



«E)ception» 
P REQUESTED RESPONSE TIME CANNOT BE DELIVERED 




«E)(oeption» 
P_REOU ESTED_ACCU RACY_CANNOT_BE_D ELIVERED 



« Except! on» 
P_TRIG GBR _CON DIT IONS_NOT_SU BSC R IBE D 



«Exception» 
TpMessaging Except ion 




«Exception» 

p_gms_property_not£set 



<<Exceptbn>> i 
P GMS MAILBOX LOOKED , 



«E xc ept icn >^\\ 
P GMS FOLDER IS O^N 




<<Excepticn>> 
P GMS MAILBOX OPEN 



«Exception» 
P GMS INSUFFICIENT PRIVILEGE 



<<Exception>i> 
P GMS CANNOT UNLOCK MAILBOX 



«Exception» 
P GMS MESSAGE NOT REMOVED 



«Exception» 
P GMS UNLOCKING UNLOCKED MAILBOX 



«Exception» 
P GMS LOCKING LOCKED MAILBOX 



«Exception» 
P GMS NUMBER NOT POSITIVE 
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«Exception» 
TpPam Exception 



/ 
/ 

/ 
/ / 

/// 

/ / / 
/ / / 

/ /// 

/ / /// 

/ / / / / / 
/ / / / / 


M.W^- 


\ 
\ 
\ 
\ 
\ 


/Ml 

# 

7 

/ 


\ \ 
\ \ 

\ 

\ 


«Exception» / 
P_PAM_ALIAS_EXISTS 


/«^xception» ' 
P_PAM_IS_CYCLIC; 


1 «Exception^>^ 
P_PAM_NOT_MEMBER 


«Exception» 
P_PAM_TYPE_EXISTS 




/ / / 1 


, 






/ / \ 


1 \ ' 




«Exception» / / 
P_PAM_MEMBER_EXISTS 


/ «Exception^^ 
/ P_PAM_TYPE_iaSSpCIATED 


«Exception» 
P_PAM_IDENTITY_EXISTS 






1 1 















«Exception» 
P_P AM_U NASSIGNED_ALiAS 


«Excep^iQn» 
P_P AM_AL 1 AS_IS| OT_U N IQU E 


«Exception» 
P_PAM_ATTRIBUTE_EXISTS 










1 1 




«Exception» 
P_P AM_D ISAS SOC 1 ATED _TYP E 


«Exception» 

p_pam_not_r',egistered 


«Exception» 
P_PAM_NO_CAP ABILITY 














«Exception» 
P_PAM_UNAVAILABLE_INTERFACE 


«Exception» 
P_PAM_AGENT_EXISTS 
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«Exception» 
TpPolicyException 



«Exception» 
P ACCESS VIOLATION 




«Exception» 
P NAME SPACE ERROR 



«Exception» 
P SYNTAX ERROR 



«Exception» «Exception» 

P TRANSACTION IN PROCESS P_NO_TRANSACTION_IN_PROCESS 
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